home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1996 #15 / Monster Media Number 15 (Monster Media)(July 1996).ISO / utils / zip202a.zip / ZIP.DOC < prev    next >
Text File  |  1996-05-30  |  69KB  |  1,308 lines

  1.  
  2.                                    ZIP.DOC
  3.                                    -------
  4.                            Instructions for ZIP.COM
  5.                           Fast File Transfer Utility
  6.                           version 2.02A (30 May 1996)
  7.  
  8.                              (c)1988-96 E. Meyer
  9.  
  10.  
  11.         Requires:  Two PC compatible computers with DOS 2.x or above;
  12.                    Null modem cable.
  13.  
  14.  
  15.  ================================== CONTENTS =================================
  16.  
  17.      1. INTRODUCTION: Brief description; Copyright and Licensing
  18.  
  19.      2. PREPARING TO USE ZIP
  20.           A. Operating modes
  21.           B. Setting serial port and speed
  22.           C. File attributes and directory creation
  23.           D. Screen output modes
  24.           E. Clock synchronization
  25.  
  26.      3. TRANSFERRING FILES
  27.           A. Sending files
  28.           B. Receiving files
  29.           C. Selecting files from a group
  30.           D. Reconciling and overwriting files
  31.           E. Backing up all subdirectories
  32.           F. Directory, Delete, and Log commands
  33.           G. Waiting for a connection
  34.  
  35.      4. SERVER MODE
  36.           A. Sending and fetching files
  37.           B. Server Directory, Delete, and Log commands
  38.           C. Comparing directory contents
  39.           D. Server Time command
  40.  
  41.      5. FURTHER USAGE NOTES
  42.           A. Summary of options
  43.           B. Examples of command-line syntax
  44.           C. Automating use of ZIP (Redirection, @files, Batch files)
  45.  
  46.      6. UTILITY PROGRAMS
  47.           A. Copying ZIP itself with ZIPDUP
  48.           B. Changing defaults with ZIPSET
  49.  
  50.      7. TECHNICAL INFORMATION
  51.           A. General information
  52.           B. About serial cables
  53.           C. Using ZIP on HP95/100/200LX palmtops
  54.           D. Error messages
  55.           E. About the program and author
  56.  
  57.  
  58.  
  59.  ============================== 1. INTRODUCTION ==============================
  60.  
  61.  
  62.      Anyone working with two computers probably needs to transfer files 
  63.  between them regularly.  But especially when large amounts of data are 
  64.  involved, exchanging floppy disks quickly grows tedious; and not all 
  65.  computers have the same disk sizes, or disk drives at all.  Keeping track of 
  66.  new or modified files on each computer gets to be a problem, too.
  67.  
  68.      ZIP is a tiny, fast utility to transfer files between two PC compatible 
  69.  computers, using a common "null modem" serial cable.  It can be used from the 
  70.  DOS command line or a batch file, or run from an interactive menu.  It 
  71.  transfers files as simply as using the COPY command, and has options that 
  72.  make it easy to back up or reconcile directories on both computers.  Ideal 
  73.  for laptop or palmtop computers, even long outdated PC's, it requires very 
  74.  little disk space and memory.
  75.  
  76.      There are good retail programs for this purpose, if you want to pay well 
  77.  over $100, and they even come with a cable.  But if you have or can find your 
  78.  own cable, ZIP offers a much cheaper alternative.  ZIP doesn't include as 
  79.  many features as these more elaborate programs; but it also doesn't take time 
  80.  to load or install, and doesn't consume precious system memory when not 
  81.  actually in use.  In fact, even if you already have another more complex 
  82.  program, you may still find ZIP easier to use in many situations because of 
  83.  its small size and simplicity.
  84.  
  85.      ZIP transfers files many times faster than the binary upload/download 
  86.  protocols (like XMODEM) of ordinary telecommunications software.  ZIP 2.0 can 
  87.  even work over twice as fast as many similar utilities that also claim to 
  88.  operate "at 115200 bps", the maximum speed of the PC serial port, because it 
  89.  uses additional techniques where feasible to further improve the transfer 
  90.  rate.  ZIP's actual throughput also depends on your computer speed, typically 
  91.  running about 8 to 10 kilobytes/second on 8086 PC's, or 16 to 24 k/sec on 
  92.  80486's; results will vary according to your system configuration and the 
  93.  size, type, and location of files involved.
  94.  
  95.      ZIP is designed to operate at very high transmission speeds with a direct 
  96.  cable connection, but it can also be used at slower speeds in applications 
  97.  that demand this.  Use with a modem over a phone connection established by 
  98.  telecommunications software is conceivable, but not recommended or supported.  
  99.  (Note: ZIP is a PC serial communications program, and has no connection with 
  100.  the more recent file archive utility "PKzip", formerly "PKARC", by Phil 
  101.  Katz.)
  102.  
  103.                          HOW YOU GOT YOUR COPY OF ZIP
  104.  
  105.      ZIP circulates widely as "shareware", giving you the opportunity to try 
  106.  the program at no cost, and to share it with others -- hence the name.  If it 
  107.  doesn't meet your needs, you don't have to pay for it.  If you find the 
  108.  program valuable and continue to use it, you can "register" your copy for a 
  109.  modest fee.  In return, you get an update disk and support from the author.
  110.  
  111.      Shareware offers some unique advantages over retail software, because 
  112.  users interact directly with the author.  Obviously, costs are kept down 
  113.  because glossy packaging, advertising, and retail markups are eliminated.  
  114.  But shareware can also resist market trends and continue to provide useful 
  115.  kinds of products that the big corporations have abandoned.  And shareware 
  116.  authors can respond more directly to user requests and concerns than software 
  117.  publishers who release an update only when it seems profitable.
  118.  
  119.      Shareware works when users give program authors useful feedback, and most 
  120.  of all, when users support authors by registering their programs.  This makes 
  121.  it possible for quality shareware to continue to develop and improve.  Please 
  122.  support shareware by registering any programs that you use.
  123.  
  124.      The use and distribution of ZIP are governed by the "COPYRIGHT AND 
  125.  LICENSE" information below.  Please read this carefully!
  126.  
  127.  
  128.                             FILES YOU SHOULD HAVE
  129.  
  130.      Be sure you have all the files which should be included in this package:
  131.  
  132.             ZIP.DOC      - This documentation file.
  133.             ZIPxx.UPD    - Update notes and version history.
  134.             ZIP.COM      - The file transfer program.
  135.             ZIPSET.COM   - The default option setting utility.
  136.             ZIPDUP.COM   - The initial duplication utility.
  137.             ZIP.ICN      - An icon for the HP100/200LX Application Manager.
  138.             ORDER.FRM    - Registration/site license order form.
  139.             FILE_ID.DIZ  - Standardized description for BBS operators.
  140.  
  141.  
  142.  
  143.                       COPYRIGHT AND LICENSE INFORMATION
  144.  
  145.          The ZIP program and documentation are copyright (c)1988-96 
  146.          Eric Meyer, all rights reserved worldwide.  They may not be 
  147.          circulated in any incomplete or modified form, nor sold for 
  148.          profit, without written permission of the author.  The use 
  149.          or sale of ZIP is subject to the following terms:
  150.  
  151.  
  152.  PERSONAL USE.  If you find ZIP valuable and continue to use it, you are 
  153.     encouraged (but not required) to register, and help support the 
  154.     development of high-quality, affordable software:
  155.                    INDIVIDUAL REGISTRATION .....  $30 (US)
  156.     Registered users receive several benefits:
  157.             * The latest version of ZIP (and other useful programs) 
  158.          on disk direct from the author.
  159.             * Technical support if you encounter problems using ZIP.  
  160.          Future upgrades can be ordered on disk when desired.
  161.             * A registration certificate verifying the legality of 
  162.          your personal use of ZIP at your workplace as well.
  163.  
  164.  
  165.  SITE LICENSES.  Any company or institution wishing to use ZIP in the course 
  166.     of its business MUST purchase a SITE LICENSE.  The cost of the license is 
  167.     modest, and varies according to the number of computers on which ZIP may 
  168.     be in use in the workplace:
  169.                 Up to 10 copies................. $50 (US)
  170.                 Up to 20 copies................ $100
  171.                 Additional copies over 20........ $2 each
  172.     The purchaser of a site license receives several benefits:
  173.             * The latest version of ZIP (and other useful programs) 
  174.          on disk direct from the author.
  175.             * Technical support if you encounter problems using ZIP.  
  176.          Future upgrades can be ordered on disk when desired.
  177.             * A license certificate documenting the legality of your 
  178.          company's use of ZIP.
  179.             * Your employees can also use ZIP at home and share it 
  180.          with others without raising issues of software piracy.
  181.  
  182.  
  183.  COMMERCIAL SALE.  Any software dealer or library may offer ZIP for sale, as 
  184.     long as the price charged for the disk containing ZIP does not exceed US 
  185.     $6 (for CDROM, $30).  With this single exception, the sale of ZIP, either 
  186.     alone or together with other software or hardware, requires a licensing 
  187.     agreement.  Please write for terms.
  188.  
  189.  
  190.  ORDERING AND SOURCES.  Site licenses and individual registrations may be 
  191.     ordered directly from the author (see address below), by check or money 
  192.     order in US currency; purchase orders are also accepted.
  193.          CREDIT CARD ORDERS (VISA,MC,AmEx,Discover), including international, 
  194.     for licenses and registrations must be made through the Public Software 
  195.     Library, P.O. Box 35705, Houston TX 77235.  TO PLACE AN ORDER ONLY, phone 
  196.     toll-free (800)242-4775; for related inquiries, phone PSL at (713)524- 
  197.     6394, fax (713)524-6398, or email PSL at CompuServe [71355,470], Internet 
  198.     71355.470@compuserve.com.  Mention item #10304.  (There is a $5 surcharge 
  199.     for credit card orders.)
  200.          ZIP is distributed widely through "shareware" channels.  Users with a 
  201.     modem can download the latest version as the archive file ZIP(xxx).ZIP, 
  202.     available from either of the two primary distribution points:
  203.     (1) Glendale Litera BBS - Glendale, CA  (818)956-6164.
  204.     (2) On CompuServe, ZIP.ZIP in library 4 (DL4) of the PCCOM forum.
  205.          In addition, ZIP circulates on a variety of other remote systems, and 
  206.     is available by mail from many good software libraries, including the 
  207.     Public Software Library (order disk #1674).
  208.  
  209.  
  210.  FOREIGN USERS.  In many countries, retail software is scarce or expensive, 
  211.     and shareware is an even more attractive alternative.  Registrations from 
  212.     overseas are warmly encouraged, and users receive full support, including 
  213.     disks by airmail, at no extra charge.  Payment can be made by inter- 
  214.     national credit card through Public Software Library; or you can send 
  215.     money orders in US currency, drawn on a US affiliate bank, directly to the 
  216.     author.  Modest amounts of US cash ($50 or less) can also be sent safely 
  217.     by registered mail.
  218.  
  219.                   Address all correspondence to the author:
  220.  
  221.             Eric Meyer
  222.           3045 4th Street             CompuServe: [74415,1305]
  223.     Boulder, Colorado  80304  USA       Internet: 74415.1305@compuserve.com
  224.  
  225.  
  226.               THE CUSTOMARY DISCLAIMER:  You undertake to use ZIP at 
  227.          your own risk.  The author does not warrant the suitability 
  228.          of ZIP for any particular purpose, and assumes no liability 
  229.          for damages of any kind resulting from its use.
  230.  
  231.  
  232.  
  233.  ========================== 2. PREPARING TO USE ZIP ==========================
  234.  
  235.  
  236.      In order to use ZIP, you need to have a copy of the same version of 
  237.  ZIP.COM on both computers, and a "null modem" cable (or equivalent) connected 
  238.  between their serial ports.  If incompatible disk drives prevent you from 
  239.  getting ZIP.COM itself onto the second computer to begin with, you can use 
  240.  the ZIPDUP utility (see COPYING ZIP ITSELF).  For further explanation of 
  241.  serial cables, or using ZIP on a Hewlett-Packard palmtop computer, see 
  242.  TECHNICAL INFORMATION.
  243.  
  244.      To achieve the fastest transfers, you should send files to/from hard 
  245.  disks or RAMdisks, rather than slow floppy disk drives.  Also, certain kinds 
  246.  of memory-resident software, especially disk compression utilities like 
  247.  Dbl/DrvSpace or Stacker, can significantly reduce ZIP's effective speed, 
  248.  particularly on slower computers like palmtops.
  249.  
  250.      If a connection cannot be established due to your cable wiring or serial 
  251.  port and speed selections, the message "Ready" or "Waiting" will remain on 
  252.  screen when you try to run ZIP; correct the problem and try again.
  253.  
  254.      While you are first learning to use ZIP, it will be easiest to put one 
  255.  computer in server mode ("ZIP /V") and operate the other in menu mode 
  256.  ("ZIP"), so you can explore the various menu selections and be prompted for 
  257.  all necessary input.
  258.  
  259.      During file transfer, ZIP will show the name and size of each file in 
  260.  succession, with a running total of the amount sent so far.  ZIP can be 
  261.  interrupted by pressing Escape, ^C, or Ctrl-Break:
  262.           (1) during the initial connection attempt;
  263.           (2) at any user prompt;
  264.           (3) during file transfer (on the receiving end, your keystroke
  265.                 will not be noticed until the current file is finished).
  266.  
  267.      CAUTION: ZIP is capable of overwriting or deleting existing files!  Be 
  268.  careful not to inadvertently destroy important files (such as those in the 
  269.  root directory of your hard disk) while learning to use this program.
  270.  
  271.  
  272.  ----------------------------- A. OPERATING MODES ----------------------------
  273.  
  274.      ZIP is a versatile program, and can be operated in a number of different 
  275.  ways.  First, you have a choice between two user interfaces:
  276.  
  277.               MENU-DRIVEN OPERATION.  Simply type "ZIP" on both 
  278.          machines.  You will see a menu of choices including 
  279.          sending, receiving, or fetching files; listing or comparing 
  280.          directories; logging a new directory; deleting files; 
  281.          entering server mode; unlinking the server; setting the 
  282.          time; changing parameters; or getting help with options.  
  283.          Just type the highlighted letter of your selection.
  284.  
  285.               COMMAND-LINE OPERATION.  Any single operation can be 
  286.          performed from the DOS command line, by providing the 
  287.          correct arguments and options.  For a brief help message 
  288.          explaining syntax and options, type "ZIP /?".
  289.  
  290.      Note that certain command-line options (/M, /A, /X, /1-4, /B) can also be 
  291.  used when invoking ZIP in menu mode (for example, "ZIP /M").
  292.      ZIP also offers two different operating modes for exchanging files, 
  293.  allowing you to choose whichever is most convenient at the time:
  294.  
  295.               SYMMETRICAL MODE.  ZIP runs the same way on both 
  296.          computers; complementary "Send" and "Receive" commands are 
  297.          executed on each end as required.  This is the first method 
  298.          described in the section TRANSFERRING FILES below.
  299.  
  300.               CLIENT/SERVER MODE.  One computer is put into "server 
  301.          mode", waiting to act as a server or slave to the other 
  302.          computer, the "client", on which all commands are executed.  
  303.          This method, which also allows further operations like 
  304.          directory comparisons, is described under SERVER MODE.
  305.  
  306.      Menu operation and client/server mode are usually most convenient when 
  307.  you plan to perform a series of tasks from the keyboard; command-line use 
  308.  provides a quick way to perform a single task, and works well in batch files.
  309.  
  310.  
  311.  -------------------- B. SETTING THE SERIAL PORT AND SPEED -------------------
  312.  
  313.      These are not factors that will complicate your everyday use of ZIP; they 
  314.  are simply options for you to be aware of.  The serial port selection only 
  315.  needs to be set once (if at all) on each computer with ZIPSET, and most users 
  316.  will never need to change the transmission speed (baud rate).
  317.  
  318.      PC-compatible computers typically have one or two serial (RS232C) ports, 
  319.  sometimes as many as four, called COM1 through COM4, and on each computer you 
  320.  must tell ZIP which port you will be connecting its cable to.  If in doubt as 
  321.  to which designation corresponds to each physical socket on your computer, 
  322.  consult your manual; see also the description of ports and cables under 
  323.  TECHNICAL INFORMATION, below.
  324.  
  325.      By default ZIP uses the COM1 port, but you can select another standard 
  326.  COM port instead: in menu mode, just choose "P"arameters, then select a port 
  327.  (1-4).  On the command line, specify the following option:
  328.  
  329.               /1-4  = use port COM1-4.
  330.  
  331.  Normally, of course, you would go to this trouble only initially, or in 
  332.  unusual circumstances; if you are going to be using ZIP regularly on a port 
  333.  other than COM1, you can simply use ZIPSET to change the default, and then 
  334.  forget about port numbers.
  335.  
  336.      Serial data transmission can take place at a wide range of speeds.  ZIP 
  337.  normally works at the fastest possible rate, 115200 bps; use of slower speeds 
  338.  is not recommended, unless you find it to be necessary to accommodate certain 
  339.  computers or software environments.  In any event, the same speed must be set 
  340.  on both ends.
  341.      In menu mode, just choose "P"arameters, then select a speed (by letter, 
  342.  from the menu).  On the command line, specify the option:
  343.  
  344.               /Bnnnn  = use speed nnnn (BPS)
  345.  
  346.  The allowed speeds "nnnn" are 115200, 57600, 38400, 19200, 9600, 4800, 2400; 
  347.  each may be abbreviated to as few as two digits ("/B96").  The default speed 
  348.  can also be changed with ZIPSET, if desired.
  349.  
  350.      You will see a note in the ZIP signon message, "Speed=____ Port=____", 
  351.  giving the port address and speed currently in use.
  352.  
  353.  
  354.  ---------------------- C. FILE AND DIRECTORY HANDLING -----------------------
  355.  
  356.      ZIP allows you to specify how you want it to handle certain DOS file 
  357.  attributes.  (If you don't know what any of this means, you can either turn 
  358.  to your DOS manual or decide not to worry about it.)  By default, ZIP does 
  359.  not list or transfer Hidden or System files; it preserves all DOS attributes, 
  360.  including Archive, as they were on each source file; and an error is 
  361.  generated if you attempt to overwrite or delete an existing Read/only file.
  362.  
  363.      You can also choose whether you want ZIP to create a new directory when 
  364.  the one you specified to receive files or log in does not already exist; by 
  365.  default, ZIP simply reports an error in such cases.
  366.  
  367.      To examine or alter these settings, in menu mode, just choose "P"aram- 
  368.  eters; then press "N" to change new directory creation, or "T" to change file 
  369.  attribute handling.  There are four attribute settings:
  370.  
  371.         include Hidden files?     preserve Archive attribute?
  372.         include System files?     overwrite Read/only files?
  373.  
  374.  Press a letter "H,S,A,R" to change any setting from YES to NO.  They may be 
  375.  specified independently on either end; the settings on the client or sending 
  376.  end govern each operation.
  377.  
  378.      On the command line, you can specify the option:
  379.  
  380.               /A  = ADD (create) new directories
  381.  
  382.  (Note: if you have used ZIPSET to make directory creation your default, the 
  383.  /A option will reverse this.)  There is no command-line option to change the 
  384.  file attribute settings, but the defaults can be changed with ZIPSET.
  385.  
  386.  
  387.  --------------------------- D. SCREEN OUTPUT MODES --------------------------
  388.  
  389.      ZIP is capable of displaying in several colors or shades on computers 
  390.  with color or greyscale capability (colors are chosen with ZIPSET).  However, 
  391.  you can instead select simple DOS (monochrome) output mode if you prefer.  
  392.  This may be desirable on displays that are hard to read or cannot display 
  393.  different colors or video attributes effectively; it is also necessary if you 
  394.  wish to redirect screen output (see AUTOMATING).  On the command line, 
  395.  specify the option:
  396.  
  397.               /M  = use MONOCHROME output
  398.  
  399.  You can also make this your default with ZIPSET.  (Note: if you have done so, 
  400.  the /M option will reverse that choice, producing color output.)
  401.  
  402.  
  403.  -------------------------- E. CLOCK SYNCHRONIZATION -------------------------
  404.  
  405.      It is advisable to ensure that the system clocks on your computers agree 
  406.  closely with each other; once they differ significantly, the timestamps on 
  407.  files may not correctly indicate which computer has the later revisions.  
  408.  Therefore, when ZIP is about to perform an operation which involves file 
  409.  timestamps, it first compares the two system clocks.
  410.  
  411.      If ZIP is performing a directory Comparison (/C) and finds that the 
  412.  clocks differ by more than the "clock synch tolerance", a warning is given.  
  413.  (The synch tolerance is 5 minutes by default, but can be changed or disabled 
  414.  with ZIPSET.)
  415.  
  416.      If ZIP is attempting a file transfer by timestamp (/T) and finds that the 
  417.  clocks differ by more than the tolerance, the transfer is aborted.
  418.  
  419.      To correct the situation, you could use the DOS commands TIME (and/or 
  420.  DATE) on each computer; better yet, you can synchronize the clocks automat- 
  421.  ically using ZIP itself.  (See SERVER TIME COMMAND.)
  422.  
  423.  
  424.  
  425.  =========================== 3. TRANSFERRING FILES ===========================
  426.  
  427.  
  428.      A SIMPLE EXAMPLE: Suppose you have a file REPORTS in directory C:\WORK on 
  429.  your laptop computer, and you'd like to send it to directory D:\JONES on your 
  430.  desktop PC.  The cable is connected between the laptop's COM1 port and the 
  431.  desktop's COM2.  Here is a single command to do it:
  432.  
  433.         Laptop:  ZIP C:\WORK\REPORTS /[D:\JONES] /1
  434.        Desktop:  ZIP /R /2
  435.  
  436.  Alternatively, you could perform the transfer in menu mode, with prompts to 
  437.  guide you through each step:
  438.  
  439.         Laptop:  ZIP /1                  Desktop:  ZIP /2
  440.                  "S"end                            "R"eceive
  441.                  Files: C:\WORK\REPORTS
  442.                  To:    D:\JONES
  443.                  "Q"uit                            "Q"uit
  444.  
  445.  Note that if either C:\WORK or D:\JONES was the current directory on the 
  446.  computer in question, it would not have had to be specified.  Also, the "/1" 
  447.  probably wasn't necessary on the laptop because COM1 is the normal default; 
  448.  similarly, if you're going to be using COM2 on the desktop all the time, you 
  449.  would want to use ZIPSET to set the desktop copy of ZIP to use COM2 as the 
  450.  default, in order not to have to specify "/2" every time.  So the transfer 
  451.  will often be as simple as:
  452.  
  453.         Laptop:  ZIP REPORTS             Desktop:  ZIP /R
  454.  
  455.      If you can get such a transfer to work, you can go on to explore the 
  456.  details which follow.  (If not, recheck your cable, port settings, etc.)
  457.  
  458.  
  459.  ------------------------------ A. SENDING FILES -----------------------------
  460.  
  461.      Transferring files between computers with ZIP is as easy as copying them 
  462.  from one disk to another.  In menu mode, simply select "S"end, and you will 
  463.  be prompted for the filename(s) and then a directory to send them to.  (For 
  464.  the default directory on the other end, just press ENTER.)  On the command 
  465.  line, give the filename(s) to send as part of the ZIP command, and if you 
  466.  want to specify a destination directory, you can add it as an option in 
  467.  brackets:
  468.               C> zip FILESPEC /[DESTDIR]
  469.  
  470.      In either mode, the "FILESPEC" can be a single FILE (including path), or 
  471.  a GROUP specified by wildcards (eg, *.BAK), or an "@FILE" (see AUTOMATING), 
  472.  or a LIST of any of these delimited by commas or spaces.  Each item assumes 
  473.  or continues the same path as the previous one, unless the new one begins 
  474.  with a drive or root directory.  Thus the list:
  475.               d:\sf\gort, ltrs\*.892, klaatu
  476.  refers to files D:\SF\GORT, D:\SF\LTRS\*.892, and D:\SF\LTRS\KLAATU.
  477.  
  478.      Any other desired options may also follow the filename(s), though only 
  479.  certain ones (/S and /N,E,T,P) are valid in menu mode.  Take care not to send 
  480.  two files with the same name to the same receiving directory, as one would 
  481.  overwrite the other.  Whether or not ZIP sends DOS Hidden or System files can 
  482.  be determined with ZIPSET.
  483.  
  484.      The size of each file to be sent is shown in "k" (1k = 1024 bytes), and 
  485.  the transfer in progress is indicated by continuously updating the amount 
  486.  sent.  This progress indication disappears when the transfer is complete.
  487.  
  488.  
  489.  ----------------------------- B. RECEIVING FILES ----------------------------
  490.  
  491.      In menu mode, simply select "R"eceive, and you will be prompted for the 
  492.  directory to receive files into.  On the command line, specify the option:
  493.  
  494.               /R  = RECEIVE files
  495.  
  496.  and, if you want, a directory to receive files into, in brackets:
  497.  
  498.               C> zip /r[DESTDIR]
  499.  
  500.      Do not supply a filespec before the /R option; the sender determines the 
  501.  files to be sent.  By default, files are received into the current directory.  
  502.  Any destination directory specified by the sender overrides the receiver's 
  503.  directory.  If the specified directory does not exist, the /A option 
  504.  determines whether ZIP attempts to create it.  Of the file selection options, 
  505.  only /P may be used when receiving.
  506.  
  507.      A received file bears the same filename, DOS timestamp, and file 
  508.  attributes as the file sent (except that whether the Archive attribute is 
  509.  preserved is user-configurable).
  510.  
  511.  
  512.  ---------------------- C. SELECTING FILES FROM A GROUP ----------------------
  513.  
  514.      If you want to transfer only certain files from a group (like *.DOC) with 
  515.  ZIP, you can request that you be prompted to confirm each file individually: 
  516.  you will be asked to press a key (Y/N) to determine whether each file is to 
  517.  be sent.  After the file (or for receiving, directory) names, in either menu 
  518.  or command-line mode, specify the option:
  519.  
  520.               /P  = PROMPT to confirm files individually
  521.  
  522.  If option /P is in use on the receiving end and "No" is entered, the message 
  523.  "<Declined>" will appear on the sending end.
  524.      This option can be specified independently on either or both ends, but 
  525.  has no effect in server mode.
  526.      (In menu mode, you can select "O"ptions for a help message describing the 
  527.  file selection options, including /P.)
  528.  
  529.  
  530.  -------------------- D. RECONCILING AND OVERWRITING FILES -------------------
  531.  
  532.      ZIP offers several features that are particulary useful for reconciling 
  533.  the contents of directories which are duplicated (in whole or part) on both 
  534.  computers.  By default, ZIP doesn't care what files may already exist on the 
  535.  receiving end: it will transfer all files specified, whether or not they 
  536.  overwrite existing ones.  Three options are provided to modify this behavior.  
  537.  After the names of files to be transferred, in menu or command-line mode, 
  538.  specify one (or two) of these options:
  539.  
  540.               /N  = copy NONexisting files only
  541.                        (cannot be used with /E or /T)
  542.               /E  = copy EXISTING files only
  543.               /T  = latest TIMESTAMP determines files sent
  544.  
  545.      The /N option will prevent all existing files from being overwritten.  
  546.  The /T option will allow overwrites only when the copy sent has a more recent 
  547.  timestamp.  The /ET combination is especially useful for selective backup 
  548.  purposes: it transfers only more recent copies of files that already exist.  
  549.  These options can be specified only on the client or sending end.
  550.      Example: if you want to make the contents of two nearly identical 
  551.  directories exactly so, do one transfer "*.* /T" each way; or use "*.* /N" 
  552.  instead if you want differing versions of individual files to remain so.
  553.      (In menu mode, you can select "O"ptions for a help message describing the 
  554.  file selection options, including /N,E,T.)
  555.  
  556.  
  557.  ---------------------- E. BACKING UP ALL SUBDIRECTORIES ---------------------
  558.  
  559.      In many situations, you may have (or want to have) a similar directory 
  560.  structure on two computers.  While you could use the above methods to produce 
  561.  this result one subdirectory at a time, ZIP offers an option to do this 
  562.  automatically.  In either menu or command-line mode, specify:
  563.  
  564.               /S  = process all SUBDIRECTORIES
  565.  
  566.  Like the /S switch of the DOS XCOPY command, this causes the given command to 
  567.  be processed on files in the specified directory, and then also in all its 
  568.  subdirectories.
  569.      The source directory, whether default or specified, is put in correspon- 
  570.  dence with a destination directory, which if not specified defaults to the 
  571.  same name as the source (note: NOT to the usual default directory!); and ZIP 
  572.  will either seek or create subdirectories of the destination directory to 
  573.  match those of the source.  Thus, if the two computers have the following 
  574.  directory trees:
  575.         Sender:  C:\                 Receiver:  D:\
  576.                     \WORK                          \BACKUP
  577.                          \PROG                            ...
  578.                          \ACCT                     \OTHER
  579.                     \GAMES                                ...
  580.  then the command "ZIP C:\WORK\*.* /S[D:\BACKUP]" will begin by transferring 
  581.  files from C:\WORK to D:\BACKUP, then from C:\WORK\PROG to D:\BACKUP\PROG, 
  582.  etc.  If any target directory (like D:\BACKUP\PROG) does not already exist, 
  583.  the /A option will cause it to be created; otherwise, the operation will 
  584.  simply terminate with an error message.
  585.  
  586.      The /S option can be combined with any of ZIP's other file transfer 
  587.  options.  It is most commonly used for backup purposes either together with 
  588.  /A, when you are trying to establish a corresponding directory structure in 
  589.  the first place, and want the required directories to be created; or after 
  590.  that, with /T, to back up files within those directories according to their 
  591.  timestamps.
  592.      Use of complete directory specifications (including drive and path) is 
  593.  recommended with /S to avoid unanticipated results.  If your attempts to 
  594.  transfer with /S repeatedly fail, matching subdirectories probably don't 
  595.  exist; make sure you have the "Add directories" option /A set.
  596.      Consider carefully before using /S to transfer the entire contents of a 
  597.  hard drive, beginning with the root directory, from one hard disk to another.  
  598.  Critical DOS files in the root directory such as AUTOEXEC.BAT, CONFIG.SYS, 
  599.  and COMMAND.COM may be overwritten by those from the other computer.
  600.  
  601.  
  602.  ------------------- F. DIRECTORY, DELETE, AND LOG COMMANDS ------------------
  603.  
  604.      When ZIP is in menu mode, it offers functions for file directory and 
  605.  deleting, and logging into a new directory, allowing simple file maintenance 
  606.  (DIR, DEL, CHDIR) without exiting ZIP.COM.
  607.      Whether or not ZIP will show or delete DOS Hidden or System files, and 
  608.  whether it will delete Read/only files, are user-configurable options.
  609.      These functions can also be applied to the other computer if it has ZIP 
  610.  running in server mode; see SERVER DIRECTORY, etc.
  611.  
  612.                                   Directory
  613.  
  614.      The "D"irectory function provides an alphabetized file listing for your 
  615.  reference, and shows the free space left on the disk (unless this is greater 
  616.  than 64 MB).  You will be prompted for the files to list.  If you just press 
  617.  [Enter], ZIP lists all files (*.*) in the default directory.  Subdirectory 
  618.  names, if any, are preceded by a backslash "\".
  619.  
  620.                                     Delete
  621.  
  622.      The d"E"lete function prompts for a filespec to delete; as always, a path 
  623.  and/or wildcards may be included.  It accepts only a single filespec, not a 
  624.  list of them.  Deletion is immediate; be careful, especially when using 
  625.  wildcards.
  626.                                      Log
  627.  
  628.      Although you can always type the full path information for any files you 
  629.  want to look for or transfer, if you're going to be working in a different 
  630.  directory for a while, it can be more convenient to change ZIP's default 
  631.  directory.  In menu mode, the "L"og command will let you do this; you will be 
  632.  prompted for the new drive and/or directory, or you can just press [Enter] to 
  633.  check the current directory.  Initially, of course, the default is the 
  634.  current DOS directory.  If the directory you specify does not exist, and the 
  635.  /A option is in effect, ZIP will create it.  (The Log command works much like 
  636.  the DOS commands CHDIR/MKDIR, except that ZIP does not actually change the 
  637.  current DOS directory, it simply keeps its own record of the directory you 
  638.  want to be working in.)
  639.  
  640.  
  641.  ------------------------ G. WAITING FOR A CONNECTION ------------------------
  642.  
  643.      Normally, once a process is initiated (file transfer, directory request, 
  644.  etc) ZIP will wait indefinitely until a connection with another copy of ZIP 
  645.  is established on the selected port.  As soon as the corresponding process is 
  646.  initiated on the other end, the operation will proceed.
  647.      However, in some circumstances this behavior may not be desirable: for 
  648.  example, a batch file containing ZIP commands would stall if ZIP was not 
  649.  found running on the other end in server or receive mode.  So an option is 
  650.  provided to have ZIP give up and exit (returning a Connect Error) if a 
  651.  connection is not promptly established.
  652.      In menu mode, just select "P"arameters, then press "X" and select an exit 
  653.  time (0-9 min).  On the command line, specify the option:
  654.  
  655.               /Xn = eXIT if no connection after n minutes (0-9)
  656.  
  657.  If "n" is not specified, it defaults to 0, meaning no waiting at all.
  658.      The /X option cannot be used with server mode, which always waits 
  659.  indefinitely.
  660.  
  661.  
  662.  
  663.  =============================== 4. SERVER MODE ==============================
  664.  
  665.  
  666.      In most situations, it would obviously be easier to transfer files if you 
  667.  could do all the typing from one keyboard, and "server mode" lets you do just 
  668.  that.  ZIP can remain on line on one end, ready to obey instructions from the 
  669.  "client" computer automatically.  To enter server mode: in menu mode, just 
  670.  choose ser"V"er.  On the command line, specify the option:
  671.  
  672.               /V  = SERVER mode
  673.  
  674.  and if you want, a new default directory for ZIP operations in brackets:
  675.  
  676.               C> zip /v[DFLTDIR]
  677.  
  678.  Otherwise, the default is the current DOS directory.
  679.      ZIP will now wait to receive commands (described below) from the other 
  680.  computer.  When you are finished, you can press Escape, ^C, or Ctrl-Break to 
  681.  exit server mode.
  682.  
  683.      Alternatively, you can give an instruction to terminate server mode from 
  684.  the other (client) keyboard.  In menu mode, choose "U"nlink before quitting.  
  685.  On the command line, specify the option:
  686.  
  687.               /U  = UNLINK server
  688.  
  689.  This option can be combined with any other ZIP function (such as a file 
  690.  send); the server is unlinked once the operation is complete.
  691.  
  692.  
  693.  ----------------------- A. SENDING AND FETCHING FILES -----------------------
  694.  
  695.      When one copy of ZIP is running in server mode, it is ready to accept any 
  696.  files that you transfer to it from the other (client) keyboard; these will be 
  697.  received on the server end, into any directory specified by the sender, or 
  698.  the server's default directory.
  699.  
  700.      You can also command the server to send files to you.  In menu mode, just 
  701.  select "F"etch (not Receive), and you will be prompted for the files to fetch 
  702.  and a directory to put them in.  On the command line, specify the option:
  703.  
  704.               /F  = FETCH specified files from server
  705.  
  706.  and, if you want, a directory to put the received files in:
  707.  
  708.               C> zip FILESPEC /f[DESTDIR]
  709.  
  710.  Otherwise they will be put in the current directory.
  711.  
  712.      If the desired files are not located in the default directory on the 
  713.  server, you must specify the (server's!) path as part of the "FILESPEC" to 
  714.  fetch.  Any of the selection options (/N,E,T,P) or directory options (/A,S) 
  715.  may be used.
  716.  
  717.  
  718.  --------------- B. SERVER DIRECTORY, DELETE, AND LOG COMMANDS ---------------
  719.  
  720.      If your other computer is running ZIP in server mode, you can also 
  721.  request a directory from it, delete files on it, or log a new directory on 
  722.  it.  In menu mode, when using the "D"irectory, d"E"lete, or "L"og commands, 
  723.  simply type a ">" before an argument to indicate that it applies to the 
  724.  server.  This can be done either alone, or following a request on the client 
  725.  end:
  726.               Directory: \WORK\*.BAK                client alone
  727.               Delete:    >B:\BACKUP\OLD.FIL         server alone
  728.               Log:       \WORK >B:\BACKUP           both
  729.  
  730.  As a convenience, since the two computers may have a similar directory 
  731.  structure, you can also type a quote mark (") to log the same default 
  732.  directory for the server.
  733.  
  734.               Log: >"              ...logs same dir on the server as client
  735.               Log: C:\WORK >"      ...logs C:\WORK on both
  736.               Log: C:\WORK >D:"    ...logs D:\WORK on the server
  737.  
  738.      On the command line, you can specify one of the options:
  739.  
  740.               /D[FILESPEC]  = Directory listing on server
  741.               /K[FILESPEC]  = Kill (delete) file on server
  742.               /L[NEWDIR]    = Log new directory on server
  743.  
  744.  /D alone lists all files "*.*", or it can be followed by a filespec in 
  745.  brackets, like "/D[\*.BAT]".  /K requires a filespec in brackets; note also 
  746.  that "K" differs from the equivalent menu mode command letter, d"E"lete.
  747.  
  748.      Directory and deletion requests accept only a single filespec, not a list 
  749.  of them.  Deletion is immediate; use caution, especially with wildcards!
  750.  
  751.  
  752.  ---------------------- C. COMPARING DIRECTORY CONTENTS ----------------------
  753.  
  754.      If your other computer is running ZIP in server mode, you can also 
  755.  compare the contents of directories, showing files that appear in one but not 
  756.  the other, or that exist in different versions.  (This can function as a 
  757.  preview of what files will be transferred if you use the /N or /T option.)  
  758.  Common identical files are not shown.
  759.      In menu mode, just choose "C"ompare.  You will be prompted for the files 
  760.  to compare.  If you just press [Enter], ZIP compares all files "*.*" in the 
  761.  default directory on each end.  Type a ">" if you want to specify a different 
  762.  directory on the server:
  763.  
  764.           Compare: >\BACKUP           client *.*   with server \BACKUP\*.*
  765.           Compare: *.DOC              client *.DOC with server *.DOC
  766.           Compare: *.DOC >\BACKUP     client *.DOC with server \BACKUP\*.DOC
  767.  
  768.      ZIP will produce two listings: first files on the client end that don't 
  769.  match up with those on the server, and then vice versa.  If a file appears on 
  770.  both ends, but in differing versions, it will be flagged with a "+" or "-" to 
  771.  indicate which appears to be the later (+) or earlier (-) version, according 
  772.  to the files' timestamps.  This is more efficient than simply displaying the 
  773.  full directory contents on both ends, as most other programs do.
  774.  
  775.      Alternatively, on the command line, you can specify the option:
  776.  
  777.               /C  = Compare with server
  778.  
  779.  All files "*.*" are compared, unless you provide a filespec.  The option can 
  780.  be followed by a directory in brackets:
  781.  
  782.               C> zip FILESPEC /c[SRVRDIR]
  783.  
  784.  otherwise, the default directory on the server is assumed.
  785.  
  786.  
  787.  --------------------------- D. SERVER TIME COMMAND --------------------------
  788.  
  789.      For an explanation of why you should keep your computers' clocks in 
  790.  agreement, see CLOCK SYNCHRONIZATION.  When your other computer is running 
  791.  ZIP in server mode, you can perform an exact synchronization with one simple 
  792.  command.  In menu mode, select "T"ime.  The current system time (and date) 
  793.  will be displayed, and you will be prompted in a manner much like the DOS 
  794.  command TIME:
  795.  
  796.               To synchronize, enter new time or press ENTER:
  797.  
  798.  You can also press Esc (as always) to quit.  Time can be entered in either 12 
  799.  or 24-hour format, as desired.  ("1:47pm" is equivalent to "13:47".)
  800.  
  801.      Performing this function periodically is an easy way to ensure that your 
  802.  computer clocks remain in agreement.
  803.      (Note: this function resets the date as well as the time on the server to 
  804.  match that on the client computer, shown; but it does not accept date 
  805.  corrections.  If necessary, exit ZIP and use the DOS DATE command.)
  806.  
  807.  
  808.  
  809.  ========================== 5. FURTHER USAGE NOTES ===========================
  810.  
  811.                             A. SUMMARY OF OPTIONS
  812.  
  813.      The following options may be used in either menu or command-line mode:
  814.               /E,N       Existing, Nonexisting files only
  815.               /T         more recent Timestamp only
  816.               /P         Prompt to confirm each
  817.               /S         process Subdirectories
  818.      These command-line options are replaced by menu choices in menu mode:
  819.               /R         "Receive" files
  820.               /F         "Fetch" from server
  821.               /V         "serVer" mode
  822.               /D[fspec]  "Directory" from server
  823.               /L[dir]    "Log" dir on server
  824.               /K[fspec]  "Delete" files on server
  825.               /C[dir]    "Compare" with server dir
  826.               /U         "Unlink" server
  827.               /1-4       port COM1-COM4       \
  828.               /Bnn       speed 2400-115200 Bps \ "Parameters"
  829.               /Xn        eXit time 0-9 sec     /
  830.               /A         Add new directories  /
  831.               /?         "Options"
  832.      This option is available only on the command line:
  833.               /M         Monochrome (DOS) output
  834.      This command is available only in menu mode:
  835.                          "Time" synchronization
  836.      These settings are available only from menu mode "Parameters":
  837.                          include Hidden, System files
  838.                          preserve Archive status
  839.                          overwrite Read/only files
  840.  
  841.  
  842.  --------------------- B. EXAMPLES OF COMMAND-LINE SYNTAX --------------------
  843.  
  844.     SENDING FILES:
  845.  
  846.  C> zip b:myfile *.doc             send files B:MYFILE, B:*.DOC
  847.  
  848.  C> zip *.bak /[b:\recs] /x1       send files *.BAK to directory B:\RECS (but
  849.                                  quit with error if no connection in 1 minute)
  850.  
  851.  C> zip my.* /2 /p                 send files C:MY.* over COM2, with prompts
  852.                                  to confirm each file individually
  853.  
  854.  C> zip *.* /n                     send all files which don't already exist
  855.                                  in receiver's default directory
  856.  
  857.  C> zip a:chapter.* /et            send all files A:CHAPTER.* of which an
  858.                                  older version exists on the receiving end
  859.     RECEIVING FILES:
  860.  
  861.  C> zip /r /3                      receive files over COM3
  862.  
  863.  C> zip /rp[\temp]                 receive, with default directory C:\TEMP,
  864.                                  prompting to confirm each file individually
  865.     BACKING UP DIRECTORIES:
  866.  
  867.  C> zip \work\*.* /sa[f:\work]     duplicate the entire subdirectory tree from
  868.                                  C:\WORK on down, to receiver's drive F:
  869.     ENTERING SERVER MODE:
  870.  
  871.  C> zip /v2b38                     wait as server, at 38400 bps on COM2
  872.  
  873.  C> zip /v[d:\]                    wait as server, with default directory D:\
  874.  
  875.     EXCHANGING FILES WITH SERVER:
  876.  
  877.  C> zip b:\recs\my.* /f[\orig]     fetch files MY.* from server directory
  878.                                  B:\RECS into client directory C:\ORIG
  879.  
  880.  C> zip my.fil,my.bak /u           send MY.FIL and MY.BAK to server's default
  881.                                  directory, then unlink server
  882.  
  883.     FILE MANAGEMENT WITH SERVER:
  884.  
  885.  C> zip /d[\work\*.bak]            show all server's files \WORK\*.BAK
  886.  
  887.  C> zip /k[junk]                   delete server's file JUNK
  888.  
  889.  C> zip *.txt /c[\mydir]           compare *.TXT with server's \MYDIR\*.TXT
  890.  
  891.  C> zip /la[c:\recs]               log server directory C:\RECS, creating it
  892.                                  if it doesn't alerady exist
  893.  
  894.  
  895.  ------------------------- C. AUTOMATING USE OF ZIP --------------------------
  896.  
  897.      There are several ways of performing complex repetitive tasks, like 
  898.  backing up several groups of files, more easily with ZIP, by taking advantage 
  899.  of its own features (indirect filename lists in "@files") or those provided 
  900.  by DOS (batch files, input/output redirection).
  901.  
  902.                               Redirected Output
  903.  
  904.      Standard DOS command line output redirection (">") can be used with ZIP.  
  905.  Thus, for example, "ZIP /D[*.BAK] >ZOUTPUT" can be used to capture the output 
  906.  of a ZIP directory listing in a file ZOUTPUT, to be examined or processed 
  907.  later.  (As a side effect, nothing displays on the screen; thus you can also 
  908.  use ">NUL" to simply suppress output, if desired.)
  909.      Note that for output redirection to work, ZIP must be using ordinary DOS 
  910.  output, not color output; this can be selected with the ZIPSET utility, or 
  911.  changed with the /M option.
  912.  
  913.                                Redirected Input
  914.  
  915.      Because ZIP accepts standard DOS input redirection ("<"), you can 
  916.  automate a frequently performed series of tasks (sending groups of files to 
  917.  different directories, etc) by running ZIP in menu mode with redirected 
  918.  input.
  919.      Redirected input is a sort of "script" describing a complex task.  You 
  920.  will need to create a text file containing exactly the keystrokes you would 
  921.  use to perform a task; think about the way ZIP prompts for input, and work 
  922.  out your responses carefully.  (Note, for example, that when you select an 
  923.  option like "S"end you don't press [Enter] afterward, but when you provide a 
  924.  filename you do.)
  925.      For example, if the file          Sc:\work\*.* /t
  926.             "ZINPUT" contains          e:\work
  927.             the following text:        Sc:\work\ed\*.* /t
  928.                                        d:\ed
  929.                                        UQ
  930.  then "ZIP <ZINPUT" would back up (with the "/T" option) all files in C:\WORK 
  931.  to directory E:\WORK on the server end, and similarly files in C:\WORK\ED to 
  932.  D:\ED, then unlink ("U") the server and quit ("Q").
  933.      Any command-line arguments or options must precede the "<" redirection 
  934.  character.  If you use the /P option while running ZIP with redirected input, 
  935.  you will still have to type any "Y/N" responses from the keyboard yourself.  
  936.  You must always end the file with "Q" to quit; DOS does not return to the 
  937.  keyboard for further input if the end of the input file is reached while the 
  938.  program is still running, so your system would just lock up without it.
  939.  
  940.                          Indirect File Lists (@files)
  941.  
  942.      A number of file management and communications utilities can write a list 
  943.  of filenames selected according to various criteria to a file, or accept the 
  944.  name of such a file following an "@" sign to process all the filenames it 
  945.  contains; ZIP also honors this convention.  You can also create such a file 
  946.  yourself, with any text editor, inserting the names of files which you may 
  947.  often want to transfer as a group.  Such an "@FILE" should contain complete 
  948.  filespecs (with drive and path), separated by spaces and/or carriage returns.  
  949.  ZIP can then be used to transfer those files.
  950.      For example, if file "FLIST" contains:    c:\work\*.bak
  951.                                                c:\myfile
  952.  then "ZIP @FLIST" will send files C:\WORK\*.BAK and C:\MYFILE.
  953.      Options can only be specified on the command line after the @file name 
  954.  (not within the @file), and will affect all files transferred.
  955.  
  956.                                  Batch Files
  957.  
  958.      Since each individual function can be performed from the command line, 
  959.  ZIP is easy to use in batch (.BAT) files.  Batch files with multiple 
  960.  invocations of ZIP run a little more slowly than the other methods above, but 
  961.  they can contain replaceable arguments, tests for the existence of files or 
  962.  directories, prompts and jumps for the user to choose different courses of 
  963.  action, and other powerful features.  See your DOS manual for details.
  964.      Use of the /X option is recommended in batch files, so that an alternate 
  965.  course of action can be taken if a connection cannot be promptly established.  
  966.  You may also want to set a larger clock synch tolerance, or disable it 
  967.  entirely, so that /T transfers do not fail unexpectedly.
  968.  
  969.      If an error occurs during operation in command-line mode, ZIP sets the 
  970.  DOS error code, so that a batch file can test the ERRORLEVEL to determine 
  971.  subsequent action.  Normally 0, the value returned will indicate which of the 
  972.  following errors occurred:
  973.      1 = argument error                   8 = transmission error
  974.      2 = out of memory/too many files    16 = disk read/write error (full?)
  975.      4 = connect error/no server        128 = user abort
  976.  It is always advisable to test for errors and abort execution of a batch file 
  977.  if an operation (upon which later actions may rely) has failed.  For example, 
  978.  the following batch file fetches certain files from a server and then deletes 
  979.  the originals on the server ONLY IF the transfer was successful:
  980.               ZIP \SOURCE\*.* /F [\DEST]
  981.               IF ERRORLEVEL 1 GOTO BADXFR
  982.               ZIP /K [\SOURCE\*.*]
  983.               :BADXFR
  984.               ZIP /U
  985.  Note that under MSDOS the test "IF ERRORLEVEL #" is true if the value is 
  986.  greater than or equal to "#", so "IF ERRORLEVEL 1" catches any error at all.
  987.  
  988.  
  989.  ============================ 6. UTILITY PROGRAMS ============================
  990.  
  991.                       A. COPYING ZIP ITSELF WITH ZIPDUP
  992.  
  993.      ZIPDUP is a simple utility that makes it possible to duplicate ZIP.COM on 
  994.  another computer initially, when your two computers don't share a common disk 
  995.  format.  Because this feature will be used only rarely, it's not part of ZIP 
  996.  itself.  ZIPDUP can, in fact, transfer any file without the need for 
  997.  receiving software, but it's very slow and cumbersome compared to ZIP itself.  
  998.  To duplicate ZIP with ZIPDUP:
  999.  
  1000.      1.  Connect the cable to the desired serial port on each computer.  You 
  1001.  must use COM1 or COM2 only; and the cable must have the DTR lines connected, 
  1002.  as well as the data lines -- see cabling diagram under TECHNICAL INFORMATION 
  1003.  below -- or ZIPDUP will not work.  (In this event, you'll need to have a 
  1004.  telecom program running on both computers, to transfer ZIP.COM via XMODEM or 
  1005.  another similar protocol.)
  1006.  
  1007.      2.  Set up the receiving end:  Make sure the DOS utilities DEBUG and MODE 
  1008.  are available (either in the current directory or in your PATH); you will 
  1009.  have to use MODE, and ZIPDUP uses DEBUG.
  1010.      Be certain that the last character of your DOS prompt is ">".  (Yes, this 
  1011.  actually matters!)  If in doubt, type the command:
  1012.               PROMPT $P$G
  1013.      Then prepare to receive data by typing these two commands:
  1014.               MODE COM#:96,N,8,1     (port "#" = 1 or 2 only)
  1015.               CTTY COM#
  1016.  (Note: on some systems, like the HP100LX, it may be necessary to add ",P" to 
  1017.  the end of the MODE command.)  The CTTY command gives control to the sending 
  1018.  computer, via the COM# port.  The receiving system will seem to "lock up", 
  1019.  ignoring any keyboard input.  If the ZIPDUP transfer fails, you will need to 
  1020.  reboot it.
  1021.  
  1022.      3.  Now, on the sending end, to duplicate your copy of ZIP.COM, type:
  1023.               ZIPDUP ZIP.COM
  1024.  (Actually, you can omit the filename if it is "ZIP.COM"; otherwise, type it.)
  1025.      You will be asked to specify the COM port (again, 1 or 2 only) that the 
  1026.  cable is connected to; if the connection can be made, the transfer will 
  1027.  proceed.  When ZIPDUP is finished, you will find a duplicate copy of ZIP.COM 
  1028.  in the current directory on the receiving computer.
  1029.  
  1030.  
  1031.  ---------------------- B. CHANGING DEFAULTS WITH ZIPSET ---------------------
  1032.  
  1033.      The ZIPSET utility allows you to customize ZIP to your own requirements.  
  1034.  Certain "defaults" that are assumed unless you specify otherwise (via 
  1035.  command-line options or menu choices) can be changed: transfer speed and 
  1036.  port, synch tolerance, attribute handling, directory creation, and colors.  
  1037.  Type:
  1038.               ZIPSET ZIP.COM
  1039.  (Actually, you can omit the filename if it is "ZIP.COM"; otherwise, type it.)
  1040.  
  1041.      To change your defaults, select "Edit" from the ZIPSET menu, make 
  1042.  changes, then select "Save"; to restore the original distribution settings, 
  1043.  select "Restore".  To exit without saving changes, select "Quit".
  1044.  
  1045.      The "Edit" procedure steps through a sequence of settings you can change.  
  1046.  For the port you may enter simply "COM1" through "COM4", or any specific 
  1047.  hexadecimal address required by your hardware ("03F0", etc).  For the speed 
  1048.  you must choose by letter from the allowed values.  For the clock synch 
  1049.  tolerance, enter a value from 1 to 99 minutes, or 0 to disable synch testing.
  1050.  
  1051.      The next set of choices configure ZIP's treatment of DOS file attributes 
  1052.  and nonexistent directories.  You can determine whether or not Hidden or 
  1053.  System files will be included in ZIP's operations; whether a file's Archive 
  1054.  attribute should be preserved when it is received on the other end; whether 
  1055.  ZIP can overwrite or delete files that have the Read/Only attribute; and 
  1056.  finally, whether ZIP should create new directories when those you specify do 
  1057.  not already exist.
  1058.  
  1059.      Then there is a setting to force 40-column display width.  Normally this 
  1060.  is set to "No"; you will see "Width=AUTO", and ZIP adapts itself to the 
  1061.  current video mode (40/80 columns).
  1062.  
  1063.      Finally, ZIPSET offers you a choice of color output (via the PC BIOS) or 
  1064.  standard DOS output.  You might want to select DOS output if color output 
  1065.  does not display correctly on your video system, or if you will want to 
  1066.  redirect output from ZIP to a file or device (color output does not 
  1067.  redirect).  Whichever default you choose, the /M option will change to the 
  1068.  other.
  1069.      If you select color, ZIPSET displays a palette and offers you a choice of 
  1070.  text colors.  ZIP uses three different colors: a "message" color, a "hilight" 
  1071.  color for contrast, and an "active" color (during file transfer activity).  
  1072.  Each is specified by an "attribute byte" consisting of two hex digits, for a 
  1073.  background and foreground color.  ("17" = "1", blue background, & "7", white 
  1074.  text.)  The color digits are:
  1075.          0 = BLACK   4 = red       8 = GREY           C = bright red
  1076.          1 = blue    5 = magenta   9 = bright blue    D = bright magenta
  1077.          2 = green   6 = brown     A = bright green   E = yellow
  1078.          3 = cyan    7 = WHITE     B = bright cyan    F = BRIGHT WHITE
  1079.      The palette will include 128 colors from 00-7F.  Use of colors 8-F as 
  1080.  background (80-FF) is also possible but not recommended, since on most 
  1081.  systems this produces blinking video.  Some colors may be invisible or 
  1082.  indistinguish-able on monochrome screens, though all MDA systems can display 
  1083.  BLACK, WHITE and BRIGHT WHITE, and in some cases GREY also.
  1084.  
  1085.      Please DO NOT distribute modified copies of ZIP.COM; this could confuse 
  1086.  other users.  (ZIPSET includes an option to restore the original default 
  1087.  values.)
  1088.  
  1089.  
  1090.  ========================== 7. TECHNICAL INFORMATION =========================
  1091.  
  1092.                             A. GENERAL INFORMATION
  1093.  
  1094.      The amount of free memory ZIP requires in order to operate is displayed 
  1095.  when the "/?" option is used.  ZIP 2.01, for example, reports: "Requires 71- 
  1096.  120-170k RAM", meaning that a minimum of 71k RAM is necessary, 120k is 
  1097.  recommended for 8086/286 systems, and ZIP will use up to 170k, if available, 
  1098.  for fastest operation on 80386/486 systems.  If this extra RAM is not 
  1099.  available on 80386/486 systems, the ZIP signon message will report "(Limited 
  1100.  memory)", indicating that optimum performance will not be achieved.
  1101.      When receiving data, ZIP writes to a temporary file, so as not to 
  1102.  overwrite any existing file until the integrity of the received file is 
  1103.  verified; there must be enough free disk space to receive the complete file.
  1104.  
  1105.      ZIP's proprietary binary transfer protocol is not compatible with those 
  1106.  of other programs, but it does include full CRC (Cyclic Redundancy Checksum) 
  1107.  verification on the data to guarantee accurate transfer.  Be sure you are 
  1108.  using the same version of ZIP on each end; if the protocol has been revised, 
  1109.  a connection will not be established.  Do not disturb the cable while ZIP is 
  1110.  transferring files, as this will abort the current operation.
  1111.  
  1112.      There is no need to worry about IRQ assignments or conflicts, but do not 
  1113.  use ZIP while another program may be accessing the same serial port.  Most 
  1114.  users also will not need to worry about "port addresses", since these have 
  1115.  become well standardized, but some computers (including IBM PS/2's) use 
  1116.  nonstandard addresses for the COM3 and COM4 ports in particular.  Check your 
  1117.  computer manual to be sure.  The standard port addresses (assumed by ZIP) 
  1118.  are:              COM1: 03F8h         COM3: 03E8h
  1119.                    COM2: 02F8h         COM4: 02E8h
  1120.  To modify ZIP for use with a nonstandard port address, you must enter the 
  1121.  address itself in hexadecimal (for example, "03F0") in place of the standard 
  1122.  entry "COM#", using ZIPSET.
  1123.  
  1124.      ZIP was designed for optimum performance in a simple DOS environment; it 
  1125.  is also compatible with Quarterdeck's DESQview, so that multitasking will not 
  1126.  interfere with its operation.  The use of ZIP within a "DOS session" in other 
  1127.  multitasking environments requires special precautions.  Under operating 
  1128.  systems like OS/2 or Windows, ZIP must be given a "non-swappable", 
  1129.  "priority", or "foreground-operation" status, so that other tasks will not 
  1130.  interrupt data transfer.  If not properly configured, you may find that ZIP's 
  1131.  performance is erratic or a slower transmission speed must be used.  Under 
  1132.  OS/2, you must not use the popular comm driver replacement SIO.SYS, which 
  1133.  apparently interferes with ZIP; IBM's own COM.SYS driver does not have this 
  1134.  problem, and has been substantially improved in a recent update.
  1135.  
  1136.      ZIP works well on the vast majority of systems.  If you experience 
  1137.  unresolvable conflicts with other memory-resident software, such as 
  1138.  background processes or disk caches, do not use ZIP when that software is 
  1139.  operating.
  1140.  
  1141.  
  1142.  -------------------------- B. ABOUT SERIAL CABLES ---------------------------
  1143.  
  1144.      Serial (RS232C) cabling can seem very complicated, but the simple fact is 
  1145.  that ZIP can transfer files using ANY serial cable that you can connect to 
  1146.  your computers!  If the cable doesn't work by itself, it will work with a 
  1147.  "null modem adapter" attached to one end; if it doesn't fit your ports, a 
  1148.  size or gender adapter can be used.  If you're shopping for a cable 
  1149.  specifically for use with ZIP, ask for a "null modem cable" with the correct 
  1150.  connectors to fit the serial ports you intend to use.  Double-headed cables 
  1151.  are also made, with both sizes of connectors on each end, to connect any two 
  1152.  PC's.  Null modem cables are inexpensive (often under $15) and widely 
  1153.  available: check your local computer store, Radio Shack, or supplies catalog.
  1154.  
  1155.      For those who may be interested, here is some further information.  
  1156.  Serial connectors come in two standard sizes, 9 pin and 25 pin; some 
  1157.  computers have both, some only one.  They may be labeled SERIAL, RS232, COM1, 
  1158.  COM2, or COMMS.  Most PC's have only one or two external serial connectors; 
  1159.  "ports" COM3 and COM4 are usually dedicated to devices such as internal 
  1160.  modems.  Due to a peculiar choice by the designers of the original IBM PC, PC 
  1161.  serial connectors are usually "male", meaning the socket has pins, rather 
  1162.  than holes to receive pins.  (If you see a socket with holes, you're probably 
  1163.  looking at your parallel printer or monitor port.)  So you will need a cable 
  1164.  with "female" connectors of the proper sizes; 3 to 6 feet is a good length.
  1165.  
  1166.      Serial cables can be wired internally in various ways: a "null modem" 
  1167.  cable, intended to connect two PC's, has the transmit and receive data lines 
  1168.  crossed.  A normal serial cable, designed to connect a PC to a communication 
  1169.  device like a modem, has these lines wired straight through, but a "null 
  1170.  modem adapter" can be attached to the cable to cross them.  (Modems have 
  1171.  their serial ports wired differently from PC's, precisely so that a straight- 
  1172.  through cable can be used to connect them: in RS232 terminology they are DCE, 
  1173.  "data communications equipment", rather than DTE, "data terminal equipment".)  
  1174.  The simplest cables contain only three wires, these two plus a ground; some 
  1175.  have seven, or more, for other signals used by some serial devices; it 
  1176.  doesn't matter for use with ZIP.  (Note: ZIPDUP alone does require the 
  1177.  additional DTR connections shown below.)  If you're building or testing a 
  1178.  null modem cable, here is the wiring diagram:
  1179.  
  1180.      |--COMPUTER 1--|             |--COMPUTER 2--|
  1181.       DB9  or   DB25               DB25  or   DB9
  1182.  pin # 2 - - - - 3 - - connect - - - 2 - - - - 3   transmit data \
  1183.        3 - - - - 2 - - -  to - - - - 3 - - - - 2   receive data   > REQUIRED
  1184.        5 - - - - 7 - - - - - - - - - 7 - - - - 5   signal ground /
  1185.  
  1186.  pin # 4 - - - - 20  - - - - - - - - 6 - - - - 6 * \
  1187.        6 - - - - 6 - - - - - - - - - 20  - - - 4 *  \ DTR,CTS etc (optional;
  1188.        7 - - - - 4 - - - - - - - - - 5 - - - - 8    / *=required for ZIPDUP)
  1189.        8 - - - - 5 - - - - - - - - - 4 - - - - 7   /
  1190.  
  1191.      Use of a short, well shielded cable is highly recommended; high speed 
  1192.  transmissions can be susceptible to RF interference.
  1193.  
  1194.  
  1195.  ------------------ C. USING ZIP ON HP95/100/200LX PALMTOPS ------------------
  1196.  
  1197.      The Hewlett-Packard 95/100/200LX palmtop computers are "nearly" PC- 
  1198.  compatible; ZIP will work on them, but there are some special considerations.  
  1199.  You will need an Infrared-capable PC or the special HP serial cable, which is 
  1200.  available either separately or as part of the Connectivity Pack.
  1201.      ZIP automatically detects the LX palmtop and its current screen size.  
  1202.  For the LX's built-in serial port, ZIP must be set to COM1; whether the Wire 
  1203.  or Infrared port is used depends on your palmtop's current setting 
  1204.  (controlled by the command SERCTL /W or SERCTL /I).  In either case, ZIP does 
  1205.  power up the port on entry and turn it off again upon exit to conserve 
  1206.  batteries, so port power can be left off in DOS.  Transfer rates with the LX 
  1207.  palmtop are typical of XT-class PC's, about 8 k/sec.
  1208.  
  1209.                                  HP 100/200LX
  1210.  
  1211.      The 100/200LX System Manager software can interfere with ZIP's use of the 
  1212.  serial port, making it difficult to transfer any but the smallest files.  Do 
  1213.  not just run ZIP from Filer, or from a DOS session under System Manager.  
  1214.  Typically, due to the complex nature of the LX palmtop, you can avoid this 
  1215.  problem in several ways:
  1216.    (1) Terminate SYSMGR (from Application Manager, press MENU,A,T,Enter) and 
  1217.  run ZIP from the DOS prompt.  Type 100 or 200 to restart SYSMGR.
  1218.    (2) Run ZIP from Application Manager after installing it like this:
  1219.                   Name: &Zip
  1220.                   Path: C:\ZIP.COM |120
  1221.                Comment: [Fn+!][Fn+?]
  1222.  The "&" lets you run ZIP by pressing "Z".  The "|120" after the Path 
  1223.  specifies a memory allocation; use the second RAM figure from the "ZIP /?" 
  1224.  information message.  An upside-down exclamation point (press Fn,!) is 
  1225.  required at the start of the Comment field to tell SYSMGR not to interrupt 
  1226.  ZIP.  The Fn,? is optional on the 200LX, to return directly to SYSMGR when 
  1227.  you select Quit.  Note that while you are editing this AppMgr entry, you can 
  1228.  install the included ZIP icon as well; just put ZIP.ICN in the same directory 
  1229.  as ZIP.COM.
  1230.    (3) Install and use Mark Scardina's free ASERCTL utility, available on the 
  1231.  CompuServe HPHAND forum, or on your ZIP registration disk.  It not only gives 
  1232.  you keyboard control over serial port power, but also prevents interference 
  1233.  from SYSMGR.  ZIP can then be run in any way you like.
  1234.  
  1235.      ZIPDUP requires a cable connection.  In order for it to send to the 
  1236.  100/200LX, you must include ",P" in the MODE command in the procedure 
  1237.  described above (MODE COM1:96,N,8,1,P).
  1238.  
  1239.                                    HP 95LX
  1240.  
  1241.      On the 95LX, ZIP can be run in a variety of ways, including from Filer 
  1242.  (highlight ZIP.COM and press F4=Run) or from the DOS system prompt.
  1243.  
  1244.      File transfers can fail on early versions of the 512k 95LX due to a bug 
  1245.  in its serial port handling.  You can avoid this by performing a [Ctrl+Up+On] 
  1246.  reset (answering "No" at the prompt, to preserve your C: drive!) before 
  1247.  running ZIP, or (for some unknown reason) by performing a Directory request 
  1248.  with ZIP before transferring files.
  1249.  
  1250.      Use of ZIP on the 95LX Infrared port is possible but not recommended; you 
  1251.  must select a speed of 2400 bps, which is all it is capable of.
  1252.      The 95LX serial port does not allow ZIPDUP to operate; instead, to 
  1253.  transfer ZIP.COM to the 95LX, you must use the 95LX's internal software: 
  1254.  either the built-in COMM utility together with any PC telecom program 
  1255.  supporting XMODEM or KERMIT protocol, or the Connectivity Pack.
  1256.  
  1257.  
  1258.  ----------------------------- D. ERROR MESSAGES -----------------------------
  1259.  
  1260.        Ready / Waiting  connection has not yet been established.
  1261.       <Argument error>  invalid command-line argument(s).
  1262.  <Insufficient memory>  not enough memory to load and run ZIP.
  1263.        <Connect error>  can't connect -- bad cable? wrong version? timeout?
  1264.            <No server>  function requires server mode on other computer.
  1265.       <Too many files>  filespec includes too many files to process at once.
  1266.  <Error reading @file>  @file nested or too large to read.
  1267.        <Bad directory>  specified directory doesn't exist or can't be created.
  1268.        <Name conflict>  filename is in use by a directory or read/only file.
  1269.         <Delete error>  specified file doesn't exist, is read/only, etc.
  1270.           <Read error>  error reading a file: access denied, etc.
  1271.          <Write error>  error writing a file: disk full, invalid path, etc.
  1272.              <Aborted>  you pressed Esc/^C/Ctrl-Break.
  1273.                <Error>  communication error, or ANY error on OTHER computer.
  1274.                           (see message on other computer for cause)
  1275.  
  1276.      Error return (ERRORLEVEL) codes are described under "Batch Files" above.
  1277.  
  1278.  
  1279.  ---------------------- E. ABOUT THE PROGRAM AND AUTHOR ----------------------
  1280.  
  1281.      As of Fall 1993, ZIP has been well reviewed in numerous computer 
  1282.  newsletters; it has been included on the HP Palmtop Paper's subscriber disk 
  1283.  for HP95/100LX users, and on disk with the following computer books:
  1284.      "DOS 6.0 Power Tools" by John Goodman & John Socha (Bantam Books)
  1285.      "DOS Stuff Microsoft Forgot" by Tim Stanley (Que Books)
  1286.      "The Little Laptop Book" by Steve Cummings (Peachpit Press)
  1287.  
  1288.  
  1289.          "lightning fast and simple to learn... simply dazzling... 
  1290.          ZIP provides the fastest file transfer between PC's using 
  1291.          the tiniest amount of disk space...  a simple, lean, and 
  1292.          very effective program, not to mention the fastest of all 
  1293.          the programs we looked at for this review."
  1294.                          -- Bil. Alvernaz, Quantum PC Report, June 1992
  1295.  
  1296.  
  1297.      Eric Meyer is also the author of the shareware VDE editor/word processor 
  1298.  and a number of free utilities for PC compatibles.  He holds an A.B. in 
  1299.  physics and a Ph.D. in history and philosophy of science, and has taught at 
  1300.  the Universities of Indiana, Oklahoma, and Colorado.  A computer enthusiast 
  1301.  since high school, he has programmed in languages from APL to Z80; lately he 
  1302.  has been working mostly in 8086 assembler.  In a period of escalating 
  1303.  software complexity and prices, he still believes that useful, inexpensive 
  1304.  software should remain available to computer users worldwide.
  1305.  
  1306.  
  1307.  ====================================[end]====================================
  1308.